Preferences Editor/bg

Other languages:
Настройки на Интерфейса
Import Export Preferences
Index

Въведение

За да отворите Редактор на предпочитанията изберете команда Edit → Preferences... от менюто или (introduced in 1.1) използвайте клавишната комбинация Ctrl +,. На macOS опцията Preferences... се появява в менюто FreeCAD вместо в Edit (това е мястото по подразбиране за предпочитания на Mac).

FreeCAD използва концепция за работни маси, където всяка работна маса е отговорна за конкретни задачи и функции. Една работна маса може да има свои собствени предпочитания. Те ще се появяват в редактора за Предпочитания, обикновено в специална група, ако работната маса е била заредена в текущата сесия на FreeCAD. Някои работни маси добавят поддръжка на конкретни формати за импортиране и експортиране. Ако има някакви свързани предпочитания, те ще се появят на една или повече допълнителни страници в групата Import-Export на редактора на предпочитанията.

За да пести ресурси, FreeCAD не зарежда автоматично всички налични работни маси. Вижте Workbenches за повече информация. За списък на предпочитанията, свързани с работна маса, вижте Workbench Related preferences.

Ако не е заредена работна маса, в редактора на предпочитанията се появяват седем 8 групи: General, Display, Workbenches, Import-Export, Python, Start, Measure и Addon Manager. Всички работни маси, които са били заредени и имат свои собствени предпочитания, ще се появят под тези.

Натискането на бутона Reset в долния ляв ъгъл на диалоговия прозорец Предпочитания отваря меню (introduced in 1.0) с опции за нулиране на предпочитанията към техните стойности по подразбиране. Можете да нулирате текущата страница, текущата група или всички предпочитания.

Някои разширени предпочитания могат да бъдат променени само в Parameter Editor. Страницата Fine-tuning изброява някои от тях.

Общи настройки

Тази група предпочитания има осем страници: General, Документ, Избор, Клавиатура (introduced in 26.3), Cache, Notification Area, Report View и Help.

General

На тази страница можете да настроите следното:

Име Описание
Език Език на потребителския интерфейс на приложението.
Система мерни единици по подразбиране Система мерни единици за всички части на приложението. introduced in 1.0: Използва се по подразбиране за Система мерни единици на документа на нови документи. Системата на активния елемент отменя системата за единица по подразбиране, освен ако не е отметната следващата опция.
Игнориране на системата единици на проекта и използване на тази по подразбиране introduced in 1.0 Ако се включи, системата мерни единици на проекта се игнорира и не отменя системата единици по подразбиране.
Брой десетични знаци Броят на десетичните знаци, които трябва да бъдат показани в дробната част на числа и размери.
Минимален фракционен инч Минималният фракционен инч, който трябва да бъде показан за числа и размери. Предлага се само за единични системи с дробни инчове.
Числен формат Задава числовия формат. Вариантите са:
  • Оперативна система': Използва се десетичният сепаратор, определен от операционната система.
  • Избран език': Използва се десетичният сепаратор на избрания език на интерфейса FreeCAD.
  • C/POSIX: Точка се използва като десетичен сепаратор.
Заместващ десетичен сепаратор Ако се провери, цифровият отделен сепаратор за клавиатура ще бъде заменен с разделителя, определен от настройката Number format. introduced in 0.21: Забележете, че ако това предпочитание е активирано, използването на цифровия отделен отдел на клавиатурата винаги ще отпечата точка/период в Python Console и Macro editor.
Тема Задава theme, за да персонализира външния вид на потребителския интерфейс.
Размер на иконите на лентата с инструменти Задава размера на иконите на лентата с инструменти. Вариантите са:
  • Малък (16px)
  • Среден (24px)'
  • Голям (32px)'
  • Екстра голям (48px)'
Изглед на дърво и режим на изглед на собственост Определя как изгледът на дървото е показан в потребителския интерфейс (изисква се рестартиране). Вариантите са:
  • Combined: Комбинира Tree View и Property View в един panel.
  • Независим': Разделя изгледа на дървото и изгледа на имота в отделни панели.
Размер на скорошния списък с файлове Задава колко файла да се показват в списъка на последните файлове.

По желание импортираните файлове могат да бъдат изключени от този списък и експортираните файлове могат да бъдат включени. Виж Fine-tuning.

Enable tiled background Ако се отметне, фонът на основния прозорец на FreeCAD по подразбиране ще се състои от плочки на това изображение:

Тази опция има ефект само ако не е избрана опция Style sheet.

Изображението може да бъде променено чрез добавяне на папките Gui/Images в папката:

%APPDATA%/FreeCAD (в Windows),

$HOME/.FreeCAD (на Linux) или

$HOME/Library/Preferences/FreeCAD (на macOS).

Сложете файл с име background.png в папка Images и поставете отметката.

Enable splash screen at start-up Ако е отметнато, при стартиране на FreeCAD се показва изскачаща картинка.

Изскачащата картинка може да бъде променена чрез поставяне на файл с име splash_image.png в папката Images, вече спомената във връзка с Enable tiled background.

Fine-grained recompute (experimental) introduced in 26.3 Activate fine-grained recomputation of documents.
Enable cursor blinking Ако сте отметнали, текстовия курсор в Python Console и Macro editor ще мига.
Activate overlay handling introduced in 1.0 Ако се отметне, скачените прозорци могат да се обработват като прозрачни наслагвания.
Preference packs Изброява наличните preference packs и също така ви позволява да ги импортирате, запазвате, управлявате и връщате.

Документ

На тази страница можете да настроите следното:

Име Описание
Създаване на нов документ в началото на Ако бъде отметнато, FreeCAD ще създаде нов документ, когато започне.
Document save compression level Задава нивото на компресия за FCStd файлове. FCStd файловетете са ZIP-компресирани файлове. Следователно можете да смените тяхното разширени от .FCStd на .zip и да ги отвори с програма за ZIP архиви.
Maximum undo/redo steps Указва колко стъпки за Undo/Redo трябва да бъдат пазени.
Allow aborting recomputation Ако се отметне, преизчисляването може да бъде прекратено чрез натискане Esc. Това може леко да увеличи времето за преизчисляване.
Enables async document recomputation introduced in 26.3 TBD
Run AutoRecovery at startup Ако има наличен файл за възстановяване, FreeCAD автоматично ще стартира възстановяване на файл, когато бъде стартиран. По този начин файловете могат да бъдат възстановени, ако се случи повреда.
Save auto-recovery information every Указва колко често се запазва файл за възстановяване.
Add thumbnail to project file when saving Ако бъде отметнао, ще се съхранява миниатюра, когато документът бъде запазен. Миниатюрата, например, ще бъде показана в списъка с последните файлове на началната страница. Възможно е да изберете Size между 128 × 128 и 512 × 512 пиксела за миниатюрата. Общите размери са комбинации от две числа: 128, 256, 512.
Add program icon to the generated thumbnail Ако се отметне, иконата на програмата FreeCAD ще бъде добавена към миниатюрата.
Максимален брой архивни файлове, които да се съхраняват при повторно запазване на документ Ако бъде отметнато, архивните файлове ще се съхраняват при запазване на документа. Можете да посочите броя на архивните файлове, които да запазите. Архивните файлове са предварително запазени версии на документа.
Use date and FCBak extension Ако бъде отметнато, архивните файлове ще получат разширението .FCbak и техните имена на файлове получават наставка за дата според посочения Date format. С настройките по подразбиране архивен файл ще получи например това име TD-Cube.20200315-215654.FCBak (оригиналното име на файла е TD-Cube.FCStd).
Show format documentation introduced in 1.1 Отваря webpage с описания на различните формати за дати
Suppress older version warning on save introduced in 1.1 Ако бъде отметнато, FreeCAD няма да покаже предупреждението, което се появява при записване на файл, създаден с по-стара версия на FreeCAD. Това предупреждение позволява да се избере Save, Save As... или Cancel, защото запазването може да замени с нов файловия формат.
Разрешаване на дублиране на етикети на обекти в един документ Ако бъде отметнато, обектите могат да имат и еднакви етикети.
Disable partial loading of external linked objects Ако е разрешено частично зареждане на външни свързани обекти, само референтните обекти и техните зависимости ще бъдат заредени, когато свързаният документ е автоматично отворен заедно с основния документ. Такъв частично зареден документ не може да бъде редактиран. Щракнете двукратно върху иконата на документа в изгледа на дърво, за да го презаредите изцяло. По-подробно обяснение на тази функция може да бъде намерено на страниц Assembly3 documenting Assembly3.
Име на автора Всички създадени документи ще получат посоченото име на автор. Дръжте полето за автор празно, ако не искате да включвате тази информация. Ако опцията Задайте при запис е отметната, полето Последно модифицирано от ще бъде зададено на посочения автор при записване на файла. Това поле може да бъде видяно с помощта на опцията Файл → Document Information.
Дружество Всички създадени документи ще получат посоченото име на фирма.
Стандартен лиценз Уточнява лиценза за нови документи. За предварително дефинирани лицензи License URL' автоматично ще бъде зададен съответно. Изберете Друг за лиценз по избор.
URL адрес на лиценза Задава URL адрес, описващ избрания в лиценз Стандартен лиценз.

Избор

На тази страница можете да настроите следното:

Име Описание
Enable preselection Ако се отметне, в 3D изглед е включено предварително избиране и за него ще се използва посочения цвят. Предварително избиране означава, че, например, ръбовете на обектите ще бъдат оцветяване, докато се движи над тях курсора на мишката, за да се посочи, че могат да бъдат избрани.
Enable selection Ако се отметне, изборът в 3D изглед е включен и посоченият цвят се използва за него. Ако не се отметне, обекти могат да бъдат избрани само в Дървовидния изглед.

Note that objects created while this option is not checked will have their ВидSelectable property set to false. With that value they are not selectable in the 3D view, even if this option is checked again.

Radius Sets the area for picking elements in the 3D View. A larger value (in px) makes it easier to pick things, but can make some small features impossible to select. The default radius may be too small for HiDPI or 4K monitors.
Preselect the object in the 3D View when hovering the cursor over the tree item Enables the Tree View PreSelection mode.
Auto switch to the 3D View containing the selected item Enables the Tree View SyncView mode.
Auto expand tree item when the corresponding object is selected in the 3D View Enables the Tree View SyncSelection mode.
Record selection in Tree View in order to go back/forward using navigation button Enables the Tree View RecordSelection mode.
Add checkboxes for selection in document tree Each Tree View item will get a checkbox. This is for example useful for selecting multiple items on a touchscreen.

Keyboard

introduced in 26.3: This page was formerly a tab in the Customize dialog box.

On this page you can define custom keyboard shortcuts for commands. Shortcuts for macros can be defined in the Customize dialog box.

Multi-key sequence delay

The time in milliseconds allowed between key presses for multi-key shortcuts.

Search

You can search for commands by entering at least 3 characters of their menu text or name in the search field. The search is case-insensitive.

It is also possible to search for shortcuts:

Add a shortcut

  1. Select a command category from the Category dropdown list.
  2. Select a command from the Commands panel. Optionally click the Command, Shortcut or Default column headings to reorder the list.
  3. The Current shortcut box displays the current shortcut, if available.
  4. Enter a new shortcut in the New shortcut input box. Shortcuts can be up to 4 inputs long. Each input is either a single character, a combination of one or more special keys or a combination of one or more special keys and a character. Use Backspace to correct mistakes.
  5. Other active commands (see Notes) that already use the shortcut will be listed in the Priority List.
  6. Press the Assign button to assign the new shortcut.
  7. If the Priority List contains more than one command: optionally change its order by selecting individual commands and pressing the Move Up button or the Move Down button. If active commands share the same shortcut, the shortcut will trigger the one that is highest in the list.

Remove a shortcut

  1. Select a command category from the Category dropdown list.
  2. Select a command from the Commands panel.
  3. Press the Clear button.

Restore a default shortcut

  1. Select a command category from the Category dropdown list.
  2. Select a command from the Commands panel.
  3. Press the Reset button.

Restore all default shortcuts

  1. Press the Reset All button.

Notes

Cache

These preferences are related to the cache directory where FreeCAD stores temporary files.

On this page you can specify the following:

Name Description
Location (read-only) Shows the path of the cache directory. Use the button to browse the directory.
Check periodically at program start Controls the frequency with which the directory size is checked. The options are:
  • Always
  • Daily
  • Weekly
  • Monthly
  • Yearly
  • Never
Cache size limit Specifies the maximum size of the directory. You will be notified if a check is performed and the size exceeds this value. The options are:
  • 100 MB
  • 300 MB
  • 500 MB
  • 1 GB
  • 2 GB
  • 3 GB
Current cache size Shows the current size of the directory, if available. Press the Check Now button to update the value.

Notification Area

These preferences control the Notification Area and its notifications.

On this page you can specify the following:

Name Description
Enable notification area If checked, the Notification Area will appear in the status bar.
Debug errors If checked, errors intended for developers will appear in the Notification Area.
Debug warnings If checked, warnings intended for developers will appear in the Notification Area.
Maximum notification count Limits the number of notifications that will be kept in the list. If 0, there is no limit.
Auto-remove user notifications If checked, notifications will be removed from the message list when the Maximum Duration has elapsed.
Enable pop-up notifications If checked, non-intrusive pop-up notifications will appear above the status bar.
Maximum duration Maximum duration during which notifications are shown (unless mouse buttons are clicked).
Minimum duration Minimum duration (idem).
Maximum concurrent notification count Maximum number of notifications that will be simultaneously present in the notification bubble.
Notification bubble width Width of the pop-up notification bubble in pixels.
Hide when other window is activated If checked, open notifications will disappear when another window is activated.
Do not show when window is inactive If checked, notifications will not appear if the FreeCAD window is not the active window.

Report View

These preferences control the behavior of the Report View. This panel can be opened using the View → Panels → Report View menu option.

The Report View uses the same font settings as the Macro editor.

On this page you can specify the following:

Name Description
Record normal messages If checked, normal messages will be recorded. They will be displayed in the Report View with the color set in Normal messages.
Record log messages If checked, log messages will be recorded. They will be displayed in the Report View with the color set in Log messages.
Record warnings If checked, warnings will be recorded. They will be displayed in the Report View with the color set in Warnings.
Record error messages If checked, error messages will be recorded. They will be displayed in the Report View with the color set in Errors.
Show report view on error If checked, the Report View will be shown automatically when an error is recorded.
Show report view on warning If checked, the Report View will be shown automatically when a warning is recorded.
Show report view on normal message If checked, the Report View will be shown automatically when a normal message is recorded.
Show report view on log message If checked, the Report View will be shown automatically when a log message is recorded.
Include a timecode for each entry If checked, each message and warning will receive a timecode.
Normal messages Specifies the font color for normal messages.
Log messages Specifies the font color for log messages.
Warnings Specifies the font color for warning messages.
Errors Specifies the font color for error messages.
Redirect internal Python output to report view If checked, internal Python output will be redirected from the Python Console to the Report View.
Redirect internal Python errors to report view If checked, internal Python error messages will be redirected from the Python Console to the Report View.

Help

On this page you can specify the following:

Name Description
Source Specifies the source of the Help files. The options are:
  • FreeCAD Wiki (online):
  • Markdown version (online):
  • GitHub (online): Cannot be selected.
  • Custom location: Enter the path where the downloaded FreeCAD documentation can be found. To download the documentation select the offline-documentation addon from the Workbenches list in the Addon Manager.

Translation suffix: For the Wiki option and the Markdown option a language suffix can be specified. Use for example fr for the French translation.

Display Specifies where the documentation should be displayed. The options are:
  • In the default web browser: The documentation is displayed in the default web browser.
  • In a FreeCAD tab: The documentation is displayed on a new tab in the Main View Area. Requires PySide Web components.
  • In a separate, embeddable, dialog: The documentation is displayed in a separate dialog. This dialog can be docked on top of the Combo View for example. Requires PySide Web components.
Custom stylesheet Specifies an optional custom stylesheet. Not used for the Wiki.

Настройки Визуализиране

Тази група предпочитания има шест стандартни страници: 3D изглед, Light Sources, UI, Навигация, Цветове и Advanced. Седма страница, Mesh View, се добавя, ако е заредена Mesh Workbench.

3D Изглед

On this page you can specify the following:

Name Description
Show coordinate system in the corner If checked, the main coordinate system will be shown in the lower right corner of the 3D View.

The Relative size defines the size of the representation as a percentage of the view size (the minimum of its height and width). The Letter color defines the color of the axis letters. introduced in 1.1: The X-axis color, Y-axis color and Z-axis color define the colors of the axes.

Show axis cross by default If checked, the axis cross will be shown by default in the 3D View.
Show counter of frames per second If checked, the time needed for the last operation and the resulting frame rate will be shown in the lower left corner of the 3D View.
Use software OpenGL If checked, OpenGL will use the CPU instead of the GPU. This option is useful for troubleshooting graphics card and driver problems. Changing this option requires a restart of the application.
Force use of OpenGL VBO (Vertex Buffer Object) If checked, Vertex Buffer Objects (VBO) will be used. A VBO is an OpenGL feature that provides methods for uploading vertex data (position, normal vector, color, etc.) to the graphics card. VBOs offer substantial performance gains because the data resides in the graphics memory rather than the system memory and so it can be rendered directly by the GPU. For more background info see Understanding OpenGL Objects.
Render cache "Render Cache" or "Render Acceleration" is explained in more detail in FreeCAD assembly3 render-caching. The options are:
  • Auto: Let Coin3D decide where to cache (default).
  • Distributed: Manually turn on cache for all view provider root nodes.
  • Centralized: Manually turn off cache in all nodes of all view providers, and only cache at the scene graph root node. This offers the fastest rendering speed, but slower response to any scene changes.
Anti-aliasing Specifies if and what type of multisample anti-aliasing is used
Transparent objects Specifies the render type of transparent objects. The options are:
  • One pass: Rendering is done in one pass (default). This can lead to triangular artifacts. If these occur the type Backface pass can be used to avoid them.
  • Backface pass: Rendering is done in two passes. Back-facing polygons are rendered in the first pass and front-facing polygons in the second pass.
Marker size Specifies the size of vertices (points) in the Sketcher Workbench. The clickable area of points can be additionally enlarged by increasing the Pick radius.
Datum size introduced in 1.1 TBD
Eye to eye distance for stereo modes Specifies the eye-to-eye distance used for stereo projections. The specified value is a factor that will be multiplied with the bounding box size of the 3D object that is currently displayed.
Camera type Specifies the camera projection type. The options are:

Light Sources

introduced in 1.0, page updated for 1.1

On this page you can specify the following:

Name Description
Main light If checked, the objects in the 3D View are lit by main light source of three-point lighting from given Horizontal Angle and Vertical Angle. The specified Color and Intensity will be used for it.
Backlight If checked, the objects in the 3D View are lit by back light source of three-point lighting from given Horizontal Angle and Vertical Angle. The specified Color and Intensity will be used for it.
Fill light If checked, the objects in the 3D View are lit by fill light source of three-point lighting from given Horizontal Angle and Vertical Angle. The specified Color and Intensity will be used for it.
Ambient light Color and Intensity settings for ambient light.
Preview The preview shows a sphere lit by the currently enabled lights. You can zoom the preview in and out with the buttons in the lower left corner.

UI

introduced in 1.0

Name Description
Accent color 1 This color might be used by your theme to let you customize it.
Accent color 2 This color might be used by your theme to let you customize it.
Accent color 3 This color might be used by your theme to let you customize it.
Style sheet (advanced) Style sheet how user interface will look like. The options are:
  • No Style sheets
  • FreeCAD
  • Defaults
Overlay style sheet The options are:
  • Auto for Automatic Overlay
  • FreeCAD Overlay for TBD?
Open Theme Editor Click on the button to open Open Theme Editor panel in order to pick up a customized theme.
Font size Font size override, set to 0 for the default value.
Icon size Icon size override, set to 0 for the default value.
Show visibility icon If checked, displays an eye icon in front of the tree view items, showing their visibility status. When clicked the visibility is toggled.
Resizable columns If checked, allows tree view columns to be manually resized.
Hide description If checked, hides column with object description in tree view.
Hide internal names If checked, hides extra tree view column for internal names.
Hide scroll bar If checked, hides scroll bar from the tree view, scrolling will still be possible using mouse wheel.
Hide header If checked, hides header with column names from the tree view.
Hide tab bar If checked, hides tab bar in dock overlay.
Hint show tab bar If checked, hides property view scroll bar in dock overlay.
Automatically hide in non-3D view If checked, automatically hides overlaid dock panels when in non 3D view (e.g. TechDraw or Spreadsheet).
Automatically pass through of the mouse cursor If checked, automatically mouse click through transparent part of dock overlay.
Automatically pass through of the mouse wheel If checked, automatically passes mouse wheel events through the transparent areas of an overlay panel.
Suggest actions in the task view based on the selection If checked, suggests actions in the task view based on the selection.

Navigation

On this page you can specify the following:

Name Description
Navigation Cube If checked, the Navigation Cube is shown in the 3D View.

Steps by turn defines the number of steps required for a full rotation when using the Navigation Cube rotation arrows.

If Rotate to nearest is checked, the 3D view is rotated to the nearest most logical position, based on the current orientation of the cube, when a cube face is clicked. Otherwise, clicking a face will always result in the same rotation.

Cube size defines the size of the cube.

Color sets the base color for all elements.

Corner defines where the Navigation Cube is displayed in the 3D View. The options are:

  • Top left
  • Top right
  • Bottom left
  • Bottom right

Font name specifies the font used for the cube's texts.

Opacity when inactive Opacity of the Navigation Cube when not hovered by the mouse. introduced in 1.0

Rotation center indicator introduced in 1.0 If checked, the rotation center of the view is shown when dragging.

The Sphere size and the Color and transparency of the indicator can be specified.

3D navigation Specifies a mouse navigation style. To see the details of each style, select it and then press the Mouse Configuration button.
Orbit style Specifies the rotation orbit style used when in rotation mode. The options are:
  • Turntable: Moving the mouse will divide the rotation in steps, rotations around the different axes are performed sequentially.
  • Trackball: Rotations around the different axes are performed simultaneously.
  • Free Turntable: Like Trackball, but if possible, the rotation axis is kept collinear with the global 3D view axis.
  • Trackball Classic: introduced in 1.1
  • Rounded Arcball: introduced in 1.1
Rotation mode Defines the rotation center. The options are:
  • Window center
  • Drag at cursor
  • Object center
Default camera orientation Specifies the camera orientation for new documents. This setting is also used by the Std ViewHome command.
Camera zoom Affects the initial camera zoom level for new documents. The value you set is the diameter of a sphere that fits in the 3D View. The default is 100 mm. It also sets the initial size of origin features (base planes in new PartDesign Bodies and Std Parts).
Zoom at cursor If checked, zoom operations will be performed at the position of the mouse pointer. Otherwise, zoom operations will be performed at the center of the current view. The Zoom step defines how much will be zoomed. A zoom step of 1 means a factor of 7.5 for every zoom step.
Invert zoom If checked, the direction of zoom operations will be inverted.
Disable touchscreen tilt gesture If checked, and 3D Navigation is set to Gesture, the tilting gesture will be disabled for pinch-zooming (two-finger zooming).
Enable support of legacy space mouse devices introduced in 1.1 If checked, legacy space mouse devices can be used.
Animations If checked, view rotations and zooms, except those invoked by mouse actions, are animated. The Animation duration can be specified.

Enable spinning animations if checked, and if 3D Navigation is set to CAD, rotations invoked by the mouse can be animated as well. If the mouse is moved while the scroll wheel and the right mouse button are pressed, the view is rotated. If one keeps the mouse moving while releasing the right mouse button, the rotation will continue. To end this animation, left-click with the mouse.

Enable long press clarify selection introduced in 1.1 Enables the Clarify Selection tool when the left mouse button (LMB) is pressed for a certain time (defined by the preference listed below). Some navigation styles (OpenInventor, Gesture and OpenSCAD) use Ctrl+LMB instead.
Long press timeout introduced in 1.1 Time in seconds to keep the left mouse button pressed in order to start the Clarify Selection tool. The possible range is 0.3 to 3 seconds. The default value is 1 second.

Colors

On this page you can specify the following:

Name Description
Simple color If selected, the background of the 3D View will have the specified color.
Linear gradient If selected, the background of the 3D View will have a vertical color gradient defined by the specified Top and Bottom colors. if enabled, a Middle color can also be specified. Press the button to switch the top and bottom colors.
Radial gradient If selected, the background of the 3D View will have a radial color gradient defined by the specified Central and End colors. if enabled, a Midway color can also be specified. Press the button to switch the central and end colors.
Object being edited Specifies the background color for objects in the tree view that are currently edited.
Active container object Specifies the background color for active containers in the tree view. For example an active PartDesign Body will get this color.
Label text color The color used for the labels of the color bar. The color bar is used in the Mesh Workbench and FEM Workbench.
Label text size The size of those labels.

Advanced

introduced in 1.0

Mesh View

This page is only available if the Mesh Workbench has been loaded.

On this page you can specify the following:

Name Description
Default mesh color Specifies the default face color.
Default line color Specifies the default line color.
Mesh transparency Specifies the default mesh transparency.
Line transparency Specifies the default line transparency.
Two-side rendering If checked, the default value for the ВидLighting property is Two side instead of One side. Two side means the color of the interior side of faces is the same as the color of the exterior side. One side means their color is either the backlight color, if enabled, or black.
Show bounding-box for highlighted or selected meshes If checked, the default value for the ВидSelection Style property is BoundBox instead of Shape. BoundBox means a highlighted bounding box is displayed if meshes are highlighted or selected. Shape means the shape itself is then highlighted.
Define normal per vertex If checked, Phong shading is used, otherwise flat shading. Shading defines the appearance of surfaces. With flat shading the surface normals are not defined per vertex. This leads to an unrealistic appearance for curved surfaces. While Phong shading leads to a more realistic, smoother appearance.
Crease angle The crease angle is a threshold angle between two faces. It can only be set if the option Define normal per vertex is used.
If face angle ≥ crease angle, facet shading is used.
If face angle < crease angle, smooth shading is used.

Workbenches

This preferences group has a single page: Available Workbenches.

Available Workbenches

These preferences control workbench loading.

On this page you can specify the following:

Name Description
Workbench list The list displays all installed workbenches. The list can be reordered by drag and drop and sorted by right-clicking the list and selecting Sort alphabetically (introduced in 1.0). The order of the list also determines the order of the Workbench selector.
  • First checkbox in each row: If checked, the workbench will be available in the Workbench selector in the next FreeCAD session. The start up workbench cannot be unchecked. Unchecked workbenches are moved to the bottom of the list.
  • Auto-load: If checked, the workbench will auto-load when FreeCAD starts. Loading more workbenches will make the start up slower, but switching between workbenches that have already been loaded is faster.
  • Load: Press this button to load the workbench in the current FreeCAD session.
Workbench selector items style introduced in 1.0 The options are:
  • Icon and text
  • Icon
  • Text
Workbench selector type introduced in 1.0 The options are:
  • ComboBox: Workbenches can be selected from a dropdown list.
  • TabBar: Workbenches can be selected from a tab bar. This takes fewer clicks than the previous option, but takes up more screen space.
Default workbench The workbench that is activated when FreeCAD starts.
Remember active workbench by tab If checked, FreeCAD will remember and restore the workbench that was active for each tab in the Main View Area.

Import-Export

The Import-Export preferences affect how files are imported and exported. They are described on the Import Export Preferences page.

Python

This preferences group has three pages: Macro, General and Editor.

Macro

On this page you can specify the following:

Name Description
Run macros in local environment If checked, variables defined by macros are created as local variables, otherwise as global Python variables.
Macro path Specifies the path for macro files.
Record GUI commands If checked, recorded macros will also contain user interface commands.
Record as comment If checked, recorded macros will also contain user interface commands, but as comments. This is useful if you don't want to execute these commands when running the macro, but do want to see what has been done while recording.
Show script commands in python console If checked, the commands executed by macro scripts are shown in the Python Console. This console can be opened using the View → Panels → Python Console menu option.
Size of recent macro list Controls the number of recent macros to display in the menu.
Keyboard shortcut count Controls the number of recent macros that get dynamically assigned shortcuts.
Keyboard Modifiers Controls which keyboard modifiers are used for the shortcuts, example Ctrl+Shift+ creates shortcuts in the form of Ctrl+Shift+1, Ctrl+Shift+2, etc.

General

These preferences control the behavior of the Python Console. This console can be opened using the View → Panels → Python Console menu option.

Note that the color and font settings for the console are defined on the Editor page.

On this page you can specify the following:

Name Description
Enable word wrap If checked, words will be wrapped if they exceed the available horizontal space in the console.
Enable block cursor If checked, the cursor will have a block shape.
Save history If checked, Python history is saved across sessions.
Python profiler interval (ms) introduced in 1.0 The interval at which the profiler runs when there is Python code running (to keep the GUI responding). Set to 0 to disable.
Path to external Python executable (optional) Used for package installation with pip and debugging with debugpy. Autodetected if needed and not specified.

Editor

These preferences control the behavior of the Macro editor. This editor can be opened using the Macro → Macros → Edit or Create menu option.

The color and font settings are also used by the Python Console. The font settings are also used by the Report View.

On this page you can specify the following:

Name Description
Enable line numbers If checked, the code lines will be numbered.
Enable block cursor If checked, the cursor will have a block shape.
Tab size Specifies the tabulator raster (how many spaces). If it is for example set to 6, pressing Tab will jump to character 7 or 13 or 19 etc., depending on the current cursor position. This setting is only used if Keep tabs is selected.
Indent size Specifies how many spaces will be inserted when pressing Tab. This setting is only used if Insert spaces is selected.
Keep tabs If selected, pressing Tab will insert a tabulator with the raster defined by Tab size.
Insert spaces If selected, pressing Tab will insert the amount of spaces defined by Indent size.
Display Items Specifies the code type the color and font settings will be applied to. The result can be checked in the Preview field.
Family Specifies the font family that should be used for the selected code type.
Size Specifies the font size that should be used for the selected code type.
Color Specifies the color that should be used for the selected code type.

Start

introduced in 1.1

This preferences group has a single page: General.

General

Name Description
Show examples folder contents Shows example files on the start page.
Show additional folder contents An optional custom folder to be displayed on the Start page. Multiple folders can be added using ;; to separate paths.
Show only FreeCAD files in additional folder Shows only FreeCAD files in additional folder.
Close start page after loading The start page is closed automatically when FreeCAD launches.

Measure

introduced in 1.0

This preferences group has a single page: Appearance.

Appearance

On this page you can specify the following:

Name Description
Text size Specifies the size of the text in pixels.
Text color Specifies the color of the text.
Line color Specifies the color of the line connecting the text label with the measured element(s).
Background color Specifies the background color of the text label.
Arrow radius introduced in 26.3 TBD
Arrow height introduced in 26.3 TBD

Addon Manager

This preferences group has a single page: Addon Manager Options.

Addon Manager Options

These preferences control the behavior of the Addon manager.

On this page you can specify the following:

Name Description
Hide addons without a license introduced in 1.0 If checked, addons without a license are not included in the listing.
Hide addons with non-FSF free/libre license introduced in 1.0 If checked, addons with a Free/Libre license not published by the Free Software Foundation are not included in the listing.
Hide addons with non-OSI-approved license introduced in 1.0 If checked, addons with a license not approved by the Open Source Initiative are not included in the listing.
Custom repositories Custom repositories can be specified here.

To add a repository press the button. Both the Repository URL and the Branch, typically master or main, must be specifies in the dialog that opens.

To remove a repository select it in the list and press the button.

Proxy addon manager trafic The Addon manager includes experimental support for proxies requiring authentication, set up as user-defined proxies.
Score source URL introduced in 1.0 The URL for the Addon Score data. See Std AddonMgr for formatting and hosting details.

Workbench related preferences

Preferences for the built-in workbenches are linked below. These links are also listed in Category:Preferences. Some workbenches have no preferences.

Scripting

See Std DlgParameter.

Свързано с темата


Настройки на Интерфейса
Import Export Preferences
Index
User documentation